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MOVING  MAP  COMPOSER  -  PERSONAL  COMPUTER  (MMCPC)  FOR  THE 
FINNISH  AIR  FORCE  SOFTWARE  DESIGN  DOCUMENT,  VERSION  1.0 


1.  INTRODUCTION 

The  Moving  Map  Composer  -  Personal  Computer  (MMCPC)  software  is  specifically  designed  and 
configured  to  support  Finnish  Air  Force  (FiAF)  F/A-18  mission  planners  and  pilots  in  the  field.  Previous 
versions  of  the  Moving-Map  Composer  (MMC)  were  installed  on  Digital  Equipment  Corporation  (DEC) 
Alpha  workstations,  which  used  the  Open  VMS  operating  system,  and  supported  the  AN/ASQ-196 
Honeywell  digital  map  system.  MMCPC  is  a  Microsoft  (MS)  Windows-based  software  application  that 
provides  data  processing  and  mission/  theater  map  data  load  support  for  the  Tactical  Aircraft  Moving 
Map  Capability  (TAMMAC)  Digital  Map  System  (DMS).  This  software  release  of  MMCPC,  in  sole 
support  of  the  FiAF  F/A-18  program,  contains  substantial  software  modifications  to  meet  specific  FiAF 
requirements.  For  more  information  about  MMC,  the  user  is  referred  to  Lohrenz  et  al.  (2004). 

MMCPC  is  comprised  of  task- specific  menus  and  tools  to  assist  FiAF  mission  planners  in  designing 
and  building  theater  and  mission  coverages  -  and  their  associated  data  loads  -  used  in  the  TAMMAC 
DMS.  This  document  details  the  MMCPC  software  design  and  includes  procedural  flowcharts  depicting 
composition  development,  data  processing,  and  data  load  methodology  in  support  of  TAMMAC. 

This  version  of  the  Software  Design  Document  records  the  design  and  development  of  MMCPC 
Version  1.0.  It  is  intended  for  use  as  a  reference  to  the  design  methodology  and  procedures  used  to 
develop  MMCPC. 

1.1  MMCPC  Overview 

This  report  documents  a  substantial  revision  of  the  MMC  system  developed  by  scientists  at  the  Naval 
Research  Laboratory  (NRL)  Geospatial  Processing  and  Analysis  (GeoPAL)  Team  (Code  7440.1). 

MMCPC  runs  on  a  Windows  XP  PC  configured  with  a  16-bit  PCMCIA  (PC  Memory  Card 
International  Association,  or  PC  card)  device  to  read  and  write  TAMMAC  mission  and  theater  map  data 
loads.  MMCPC  enables  mission  planners  to  perform  the  following  functions: 

•  Process  FiAF  source  Geospatial  Tagged  Image  File  Format  (GeoTIFF)  files  into  a  Compressed 
Arc  Digitized  Raster  Graphics  (CADRG)  compatible  format; 

•  Process  FiAF  and  National  Geospatial-Intelligence  Agency  (NGA)  source  Digital  Terrain 
Elevation  Data  (DEED)  into  a  TAMMAC-compatible  Regridded  DEED  (RDTED)  format; 

•  Define  and  save  regions  of  interest  (ROI)  for  mission  and  theater  map  data  loads  as  a  series  of 
bitmap  representations; 
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•  Populate  these  ROIs  with  data  from  user-specified  FiAF  GeoTIFF  files  (converted  to  CADRG 
formatted  files  via  MMCPC),  NGA  CADRG  data,  FiAF  and/or  NGA  RDTED  data,  and  NGA 
Controlled  Image  Base  (CIB)  data; 

•  Import  and  convert  non-georeferenced  images  (e.g.,  Graphics  Interchange  Format  (GIF)  files) 
into  TAMMAC-compatible  data  frames; 

•  Write  completed  TAMMAC  theater  map  data  loads  to  PC  cards  for  aircraft  loading; 

•  Build  mission  planning  data  loads  from  user-specified  CADRG,  RDTED,  CIB,  and  data  frames 
for  use  in  the  FiAF  Mission  Planning  System  (MPS); 

•  Print  final  compositions,  CADRG  images,  data  frames,  and  map  load  summaries. 

1.2  Document  Overview 

This  document  describes  the  software  design  for  MMCPC,  including  a  history  of  the  system’s 
development,  a  technical  description  of  the  MMCPC  architecture  (built  to  accommodate  specific  data 
processing  protocols,  map  composition  requirements  and  map  data  operations),  and  the  MMCPC 
Graphical  User  Interface  (GUI).  A  final  section  discusses  error  checking  and  handling. 

This  document  is  intended  for  software  engineers  and  developers  who  require  a  thorough 
understanding  of  the  MMCPC  software  functionality  and  technical  design.  It  may  also  be  used  as  training 
material  for  new  project  members  and  users.  This  document  will  be  updated  periodically  to  reflect 
software  revisions  driven  by  changing  FiAF  program  requirements. 

1.3  System  Overview 

MMCPC  provides  tools  to  define  geographic  ROIs,  populate  these  regions  with  digital  geospatial  data 
(including  digital  charts,  satellite  imagery,  and  terrain  elevation  data),  and  build  mission  and  theater  map 
data  loads  to  be  imported  into  the  FiAF  MPS  and  TAMMAC  DMS.  Figure  1  illustrates  the  data  flow 
among  these  three  systems  (MMCPC,  MPS,  and  TAMMAC  DMS). 

MMCPC  is  organized  around  three  primary  tasks  -  Data  Processing,  Map  Composition,  and  Map 
Data  Operations  -  each  of  which  requires  a  set  of  GUI  functions.  Functional  requirements  are  driven  by 
one  or  more  of  these  tasks.  Many  MMCPC  requirements  were  inherited  from  the  original  MMC  software. 
Data  Processing  requirements  (Fig.  2)  include  identification  of  acceptable  source  data  (e.g.,  GeoTIFF 
source  files  at  predefined  map  scales)  and  color  palette  verification  and  validation.  Map  Composition 
requirements  (Fig.  3)  include  procedures  and  tools  to  define  geographic  regions  of  interest  at  multiple 
map  scales  and  types.  Map  Data  Operations  requirements  (Fig.  4)  include  procedures  and  tools  to  read 
and  display  all  data  types,  log  and  maintain  processed  data,  and  perform  color  map  operations. 

1.4  Data  Formats 

MMCPC  supports  map  data  processing  and  output  formats  compatible  with  the  TAMMAC  DMS. 
TAMMAC  displays  three  georeferenced  data  types:  CADRG,  RDTED,  and  CIB.  TAMMAC  also 
displays  non-georeferenced  data  frames  in  Harris  Defined  Format  (HDF),  described  in  Harris  (2002). 
Each  of  these  is  supported  in  MMCPC,  as  are  support  files  and  data  structures  identified  in  the 
TAMMAC  performance  specification  (Boeing  2001).  All  final  TAMMAC  data  files  are  written  to  pre¬ 
formatted  PCMCIA  cards. 

Legacy  data  types  (e.g..  Compressed  Aeronautical  Chart  (CAC)  and  ADRG)  from  MMC  v3.4P  are 
not  supported  in  TAMMAC  or  MMCPC,  nor  are  the  data  structures,  output  devices,  or  storage  media 
specific  to  the  Honeywell  AN/ASQ-196  DMS. 
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Fig.  1 —  Data  flow  among  MMC-PC,  MPS,  and  TAMMAC  systems 


1.5  Design  Approach 

A  primary  MMCPC  software  design  goal  was  to  create  an  appearance  and  behavior  similar  to  other 
common  Windows-based  products.  The  MMCPC  functional  diagrams  (Figs.  2  through  4)  were  used  to 
build  a  requirements  matrix  (Appendix  A),  which  was  redefined  and  expanded  during  a  series  of  design 
reviews,  and  was  subject  to  mutual  approval  by  technical  representatives  from  NRL,  NAVAIR,  and  the 
FiAF. 

Procedures  were  developed  to  accommodate  the  final  requirements  matrix.  Leveraging  the  FiAF 
experience  and  familiarity  with  the  original  MMC  software,  MMCPC  requirements  were  mapped,  when 
possible,  to  existing  MMC  GUI  components.  The  software  development  tool  kit  QT,  which  contains 
templates  for  creating  Windows-like  applications,  was  used  to  design  and  create  GUIs  and  generate  C++ 
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programming  language  code.  Some  Map  Data  Processing  modules  were  written  in  C  and  later  linked  into 
MMCPC  as  object  libraries. 


Fig.  2  —  MMCPC  data  processing  functional  diagram 


Fig.  3  —  MMCPC  map  composition  functional  diagram 
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Fig.  4  —  MMCPC  map  data  operations  functional  diagram 

GUI  menus  and  options  were  created  to  provide  the  user  with  tools  that  are  easy  to  use  and  facilitate 
the  required  tasks.  Each  GUI  option  is  linked  to  at  least  one  matrix  requirement  (Appendix  B).  Shortcuts 
and  hotkeys  for  GUI  options  are  defined,  as  are  actions,  conditions,  and  usage  cases  (i.e.,  when  the  menu 
option  is  available  for  use).  Since  a  primary  goal  was  to  create  a  similar  appearance  and  behavior  found 
in  other  commercial  Windows-based  software,  comparable  design  conventions  were  followed  and 
implemented.  For  example,  file  browsers  were  designed  to  offer  access  to  all  valid  storage  devices  and 
directory  locations. 

2.  MMCPC  ARCHITECTURE 

The  MMCPC  architecture  supports  the  three  primary  tasks  described  above  (data  processing,  map 
composition,  and  map  data  operations)  along  with  GUI  communications  and  error  checking  functions. 
This  section  describes  the  design  and  implementation  of  each. 

2.1  Data  Processing 

The  first  step  in  developing  TAMMAC  theater/mission  data  loads  is  to  process  any  of  several  types  of 
source  data  from  FiAF  or  NGA  (Table  1)  into  a  TAMMAC-compatible  format.  NGA  CADRG  and  CIB 
are  already  TAMMAC-compatible  and  require  no  MMCPC  processing.  The  following  sections  of  this 
report  describe  the  three  data  processing  functions  provided  in  MMCPC  to  prepare  the  non-compatible 
data  types: 

•  Process  FiAF  source  GeoTIFF  files  into  the  CADRG  format  (MIL-C-89038:  NGA  1994). 

•  Regrid  FiAF  or  NGA  source  DTED  (MIL-PRF-89020A:  NGA  1996)  into  RDTED. 

•  Reformat  non-georeferenced  images  into  HDF  formatted  data  frame  files  (Harris  2002). 
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Table  1  —  Source  Data  for  MMCPC 


Source 

Data  Type 

FiAF 

GeoTIFF 

FiAF  &  NGA 

Digital  Terrain  and  Elevation  Data  (DTED)  -  level  1  (100m) 

Any 

Data  frames  (TIF,  GIF,  PNG,  BMP,  JPEG,  and  HDF  images) 

NGA 

Compressed  Arc  Digitized  Raster  Graphics  (CADRG) 

NGA 

Controlled  Image  Base  (CIB) 

2.1.1  FiAF  GeoTIFF  to  CADRG  Processing 

CADRG  data  is  processed  from  source  FiAF  GeoTIFF  data  for  use  in  the  creation  of  TAMMAC 
theater  and  mission  loads.  Once  processed,  this  data  is  available  for  use  in  other  MMCPC  compositions. 
Figure  5  provides  an  overview  of  CADRG  processing,  which  includes  five  critical  phases  (color-coded 
consistently  throughout  this  section):  1)  determine  finalization  status  (blue);  2)  validate  directory 
structure  and  source  data  (orange);  3)  define  destination  path  (green);  4)  validate  color  palettes  (yellow); 
and  5)  process  data  (purple).  Appendix  C  provides  a  full  description  of  CADRG  processing,  including 
low-level  steps  within  each  phase. 

2.1. 1.1  Determine  CADRG  Finalization  Status 

The  finalization  procedure  determines  whether  partial  map  segments  (i.e.,  processed  map  files  that  are 
not  completely  filled  with  map  data)  should  be  fully  processed  or  should  remain  in  a  partial  state  until 
additional  data  is  appended  to  the  files.  CADRG  data  processing  begins  in  one  of  two  initial  states:  1)  all 
previous  CADRG  processed  data  has  been  finalized  or  2)  unfinalized  CADRG  data  exists  on  the  system. 
Processing  is  assumed  to  be  in  the  first  state  when  MMCPC  is  used  to  process  FiAF  GeoTIFF  source  files 
into  CADRG.  When  unfinalized  data  are  detected,  MMCPC  prompts  the  user  to  either  finalize  the 
remaining  map  files  or  append  additional  data. 

Data  should  not  be  finalized  (see  Section  2. 1.1.5)  when  multiple  sets  of  source  GeoTIFF  data  (i.e., 
multiple  data  CDs)  are  used  until  the  last  data  set  is  loaded  into  MMCPC.  This  allows  the  user  to  process 
the  current  set  of  source  data  and  resume  processing  another  time.  Alternatively,  data  is  finalized  when 
all  source  data  is  processed  at  once,  from  one  source  media;  however,  it  cannot  be  appended  later  with 
additional  processed  data. 

After  MMCPC  has  determined  the  status  of  CADRG  finalization,  it  defines  the  data  source  and 
destination  paths.  If  unfinalized  data  exists,  the  user  may  choose  to  either  finalize  the  previous  set  of  data 
or  append  more  map  data  to  the  previously  processed  data  set.  When  the  user  chooses  to  append  to  the 
data,  the  destination  path  for  the  newly  processed  data  is  automatically  preset  to  the  destination  of  the 
existing  data.  If  the  existing  processed  data  was  finalized,  then  the  user  must  define  the  path  to  the  FiAF 
GeoTIFF  source  data  and  the  destination  path  (Fig.  6). 
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Fig.  5  —  High-level  flow  ehart  for  CADRG  data  proeessing 


Fig.  6  —  Control  flow  for  CADRG  finalization  phase 
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2.1. 1.2  Validate  Source  Directory  Structure  and  Data  for  CADRG  Processing 

After  source  and  destination  paths  are  set,  MMCPC  verifies  the  FiAF  GeoTIFF  directory  structure 
(Fig.  7).  If  it  is  invalid,  an  error  message  is  displayed,  CADRG  data  processing  halts,  and  MMCPC 
returns  to  the  main  window.  If  the  structure  is  valid,  the  header  record  of  every  GeoTIFF  file  in  the 
destination  directory  is  read  and  verified  (Fig.  8).  If  the  source  is  on  CD,  the  volume  label  must  be 
FAF  GTIF.  A  valid  source  includes  a  root  directory,  at  least  one  subdirectory,  and  a  TIF  file.  The  source 
must  be  8-bit  GeoTIFF;  MMCPC  does  not  yet  support  24-bit  GeoTIFF.  MMCPC  verifies  that  each 
source  GeoTIFF  longitude  bound  is  within  3°  of  its  original  longitude  to  minimize  geospatial  processing 
errors  during  transformation  to  CADRG.  If  the  bounds  are  invalid,  the  steps  are  repeated  until  a  valid 
directory  structure  is  passed  or  the  operation  is  cancelled.  See  Section  2.5  for  MMCPC  error  handling. 


Fig.  7  —  Source  GeoTIFF  directory  structure 


Fig.  8  —  Control  flow  for  CADRG  directory  path  and  data  validation  phase 

2.1. 1.3  Define  CADRG  Destination  Path 

After  the  source  FiAF  GeoTIFF  files  have  been  verified,  the  destination  path  is  created,  if  it  does  not 
already  exist  (Fig.  9).  The  destination  directory  path  provided  by  the  user  will  be  appended  with  a  unique 
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MMCPC-assigned  subdirectory  path,  or  Processed  Unique  Identification  (PUID),  in  the  form  of 
CDRGFIAFxxxx_s,  where  xxxx  is  a  unique  number  (0001-9999)  and  S  is  a  system  identifier  (A-Z) 
assigned  by  the  MMCPC  system  administrator  during  installation.  For  example,  if  the  user  chooses 
destination  directory  C:\MMCPC\Data\CDRG  for  the  first  FiAF  geotiff  data  processed  on  the  system, 
with  an  identifier  of  “A,”  then  the  final  path  to  the  processed  CADRG  data  will  be 
C:\MMCPC\Data\CDRG\CDRGFIAF0001_A.  Figure  10  gives  an  example  of  a  full  CADRG 
directory  structure  processed  by  MMCPC. 


Fig.  10  —  CADRG  data  directory  structure 
and  file  naming  convention 


2.1. 1.4  Validate  Color  Palettes 

Each  map  scale  supported  in  CADRG  uses  a  standard  8-bit  color  palette.  During  installation  of 
MMCPC,  a  default  set  of  NGA  color  palettes  is  automatically  loaded  onto  the  system.  This  default  set  of 
palettes  is  also  used  to  process  FiAF  geotiff  into  CADRG  only  if  no  custom  color  palettes  are  provided 
with  the  geotiff.  There  is  no  need  to  maintain  the  default  color  palettes  to  use  NGA  CADRG  in 
combination  with  processed  FiAF  CADRG.  NRL  recommends  that  FiAF  operators  use  their  own  custom 
color  palettes  for  processing  geotiff  files  into  CADRG  to  improve  color  accuracy.  The  user  may  process 
multiple  data  sets  with  different  color  palettes  without  making  the  previous  map  data  obsolete. 

The  format  of  the  custom  color  palette  file  (PALETTE.TXT)  is  shown  in  Fig.  11.  The  first  line  of 
the  file  contains  the  number  of  colors  in  the  palette  (maximum  =  216).  If  the  actual  number  of  colors 
does  not  match  the  first  line,  the  file  will  be  considered  incorrect  and  the  map  data  will  not  be  processed. 
Each  successive  line  after  the  first  contains  the  text:  “Set  n  r  g  b”  where  n  is  a  sequential  color  identifier 
and  r  g  b  are  the  red,  green,  and  blue  values  (from  0  to  255)  of  the  color.  Note  that  the  “S”  in  “Set”  must 
be  capitalized.  Each  value  is  delimited  by  a  single  space. 
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Sell 

54  232  240  240 

Sample  file  contents 


Fig.  11  —  FiAF  custom  color  palette  format  and  sample  file  with  154  colors  (maximum  =  216) 


MMCPC  CADRG  data  processing  routines  determine  whether  a  custom  color  palette  exists  for  each 
scale  of  source  GeoTIFF  file  (Fig.  12).  When  a  custom  color  palette  file  is  detected,  it  is  compared  to  the 
installed  color  palette  on  MMCPC  for  that  scale.  If  the  color  values  of  the  two  palettes  are  identical, 
processing  proceeds  normally.  If  a  difference  exists  between  the  custom  color  palette  and  the  MMCPC- 
installed  palette  for  one  or  more  map  scales,  the  user  is  notified  that  new  color  palette(s)  will  be  installed 
for  those  scale(s).  The  user  must  then  decide  to  either  cancel  CADRG  data  processing  or  to  proceed.  By 
proceeding,  the  user  has  decided  to  install  all  of  the  custom  color  palettes  for  that  scale. 

If  the  current  set  of  source  GeoTIFF  data  is  to  be  appended  to  the  previous  set  of  processed  data,  an 
additional  check  is  made  to  validate  the  color  palettes.  For  append  processing,  any  color  palettes 
associated  with  the  source  data  must  match  the  installed  color  palettes  (by  scale).  All  map  scales  must 
have  either  default  color  palettes  or  custom  color  palettes  that  are  identical  to  the  ones  already  installed. 
If  the  color  palettes  aren’t  identical,  an  error  condition  is  detected,  and  CADRG  data  processing  stops. 
Note:  custom  color  palettes  (and  all  associated  actions)  are  not  installed  on  the  MMCPC  system  until  data 
processing  actually  begins. 
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Fig.  12  —  Control  flow  for  color  palette  validation 


2.1. 1.5  Process  CADRG  Data 

After  all  color  palettes  checks  are  complete,  the  CADRG  processing  dialog  box  prompts  the  user  for 
the  following  information: 

■  Set  Finalize  Automatically  (default  =  yes):  If  all  source  data  will  be  processed  at  once,  from  one 
source  media,  this  default  setting  will  finalize  the  processed  data  and  not  allow  any  additional  data  to 
be  appended.  This  setting  should  be  disabled  (toggled  to  “no”)  when  multiple  sets  of  source  GeoTIFF 
data  (i.e.,  multiple  data  CDs)  will  be  used,  or  when  source  data  will  be  processed  in  multiple  parts. 
Disabling  this  setting  will  allow  the  user  to  process  the  current  set  of  source  data  and  resume 
processing  later  with  no  discontinuity. 

■  Set  Delete  Unfilled  Segments  (default  =  no):  Removes  partially  filled  processed  map  files  from  the 
final  processed  CADRG.  This  option  is  not  applicable  if  the  preceding  setting  {Set  Finalize 
Automatically)  is  disabled. 
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■  Descriptive  Name:  A  name  for  this  processed  data  (maximum  of  16  ASCII  characters). 

The  CADRG  processing  dialog  box  shows  the  estimated  map  data  coverage  (after  processing)  for 
each  scale.  The  user  reviews  this  information  and  either  proceeds  with  CADRG  data  processing  (by 
clicking  PROCESS)  or  aborts  the  pending  action  (CANCEL).  When  processing  begins  (Fig.  13),  new 
custom  color  palettes  are  installed  for  the  applicable  map  scales. 


Fig.  13  —  Control  flow  for  CADRG  data  processing 


Next,  all  source  GeoTIFF  data  are  processed  into  CADRG  format  and  stored  in  the  selected 
destination  directory.  If  the  user  has  chosen  to  finalize  automatically,  an  A. TOC  (Table  of  Contents)  file 
is  created  at  the  \rpf  (Raster  Product  Format)  directory  level  (Fig.  10),  and  the  processed  map  data  is 
logged  into  MMCPC  to  create  compositions  and  TAMMAC  theater/mission  data  loads.  If  the  user  has 
chosen  n^  to  finalize,  no  A. TOC  is  created,  and  the  processed  map  data  are  not  logged.  Processed  map 
data  cannot  be  used  to  create  compositions  or  TAMMAC  map  loads  until  they  have  been  logged.  Map 
data  logging  is  discussed  in  Section  2.1.3. 

The  error  checking  functions  used  during  CADRG  data  processing  provide  descriptive  error  messages 
to  assist  the  user  in  correcting  any  problems  associated  with  the  source  data.  For  example,  if  a  corrupt 
GeoTIFF  source  file  is  encountered,  MMCPC  will  attempt  to  read  the  remaining  files  and  report  any 
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errors  associated  with  source  GeoTIFF  files  prior  to  exiting  CADRG  processing.  Consequently,  the  user 
can  fix  all  potential  data  problems  in  one  session. 

2.1.2  RDTED  Processing 

DTED  is  processed  into  RDTED  at  750  m  (1:5M)  and  150  m  (1:1M)  scales,  both  of  which  are 
automatically  included  when  defined  in  a  composition.  RDTED  is  formatted  for  use  with  CADRG  during 
Mission  and  Theater  load  builds.  Figure  14  provides  an  overview  of  RDTED  processing,  which  includes 
four  critical  phases  (color-coded  consistently  throughout  this  section): 

1)  Determine  finalization  status  (blue) 

2)  Validate  directory  structure  and  source  data  (orange) 

3)  Define  destination  path  (green),  and 

4)  Process  data  (purple). 

Appendix  D  provides  a  complete  description  of  RDTED  processing,  including  low-level  steps  within 
each  phase. 


Fig.  14  —  High  level  flow  ehart  for  RDTED  proeessing 
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2.1.2.1  Determination  of  Finalization  Status 

As  discussed  earlier,  finalization  determines  whether  partial  map  segments  (i.e.,  processed  files  that 
are  not  completely  filled  with  map  data)  should  be  fully  processed  or  should  remain  in  a  partial  state  until 
additional  data  is  appended  to  the  files.  Like  CADRG  processing,  RDTED  processing  begins  in  one  of 
two  initial  states:  1)  all  previous  RDTED  processed  data  have  been  finalized  or  2)  unfinalized  RDTED 
exists  on  the  system.  Processing  is  assumed  to  be  in  the  first  state  when  MMCPC  is  used  to  process  FiAF 
GeoTIFF  source  files  into  CADRG.  When  unfinalized  data  are  detected,  MMCPC  prompts  the  user  to 
either  finalize  the  remaining  map  files  or  append  additional  data  (Fig.  15). 


Fig.  15  —  Control  flow  for  RDTED  finalization 


Data  should  not  finalized  (Section  2. 1.2.4)  when  multiple  CDs  of  source  DTED  data  are  used  until  the 
last  CD  is  loaded.  This  allows  the  user  to  process  the  current  set  of  source  data  and  resume  processing 
another  time.  Data  can  be  finalized  when  all  source  data  are  processed  at  once,  from  one  CD,  but  it 
cannot  be  appended  later  with  additional  processed  data. 

After  MMCPC  has  determined  the  status  of  RDTED  finalization,  it  defines  the  data  source  and 
destination  paths.  If  unfinalized  data  exists,  the  user  may  choose  to  either  finalize  the  previous  set  of  data 
or  append  more  map  data  to  the  previously  processed  data  set.  When  the  user  chooses  to  append  to  the 
data,  the  destination  path  for  the  newly  processed  data  is  automatically  preset  to  the  destination  of  the 
existing  data.  If  the  existing  processed  data  were  finalized,  then  the  user  must  define  the  path  to  the 
source  DTED  (FiAF  or  NGA)  and  the  destination  path. 
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2.1.2.2  Validate  Source  Directory  Structure  and  Data  for  RDTED  Processing 

After  the  source  and  destination  paths  are  set,  MMCPC  verifies  the  source  DTED  directory  structure 
(Fig.  16).  If  the  directory  structure  is  invalid,  an  error  message  is  displayed,  DTED  data  processing  halts, 
and  MMCPC  returns  to  the  main  window.  If  the  directory  structure  is  valid,  the  cell  header  information 
of  every  DTED  file  in  the  destination  directory  is  read  and  verified  (Fig.  17).  If  the  source  DTED  data  are 
on  CD  and  from  FiAF,  the  volume  header  must  be  labeled  FAF_DTEDxxx  (where  xxx  is  a  unique 
numerical  identifier).  The  DTED  directory  structure,  file  structure,  and  file  naming  conventions  must 
conform  to  the  DTED  specification  MIL-PRF-89020B  (NGA  2000). 


Fig.  16  —  Source  DTED  directory  structure 


First  level  subdirectory  names  are  derived  from  headings  and  longitude  coordinates.  For  example, 
subdirectory  E027  is  derived  from  27  degrees  East  longitude.  Leading  “0”  placeholders  are  required  for 
longitude  values  less  than  100.  Each  subdirectory  may  contain  multiple  DTED  Level  I  cells  that  are  each 
1  degree  by  1  degree  in  size,  with  post  spacing  determined  by  geographic  zone. 

MMCPC  verifies  that  the  DTED  directory  structure  is  correct  and  at  least  one  valid  DTED  cell  exists. 
MMCPC  supports  DTED  Level  I  source  data  (100  m  resolution)  for  processing  into  RDTED.  Section  2.5 
provides  further  discussion  on  MMCPC  error  handling. 
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2.1.2.3  RDTED  Destination  Path  Creation 

After  the  source  DTED  files  have  been  verified,  the  destination  path  is  created,  if  it  does  not  already 
exist  (Fig.  18).  The  destination  path  provided  by  the  user  will  be  appended  with  a  unique  MMCPC- 
assigned  subdirectory  path,  or  PUID,  in  the  form  of  RDTDFIAFxxxx_s,  where  xxxx  is  a  unique  number 
(0001-9999)  and  S  is  a  system  identifier  (A-Z)  assigned  by  the  MMCPC  system  administrator  during 
installation. 

For  example,  if  the  user  chooses  destination  directory  C:\MMCPC\Data\RDTD  for  the  first  DTED 
data  processed  on  the  system,  with  an  identifier  of  “A,”  then  the  final  path  to  the  processed  RDTED  data 
will  be  C:\MMCPC\Data\RDTD\RDTDFIAF0001_A.  Figure  19  gives  an  example  of  a  full  RDTED 
directory  structure  processed  by  MMCPC. 
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Fig.  18  —  Control  flow  for  RDTED  destination  path  creation 


Fig.  19  —  RDTED  data  directory  structure 
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2.1.2.4  Process  RDTED  Data 

Figure  20  presents  the  control  flow  for  processing  DTED  into  RDTED.  First,  the  RDTED  processing 

dialog  box  prompts  the  user  for  the  following  information: 

■  Set  Finalize  Automatically  (default  =  yes):  If  all  source  data  will  be  processed  at  once,  from  one 
source  media,  this  default  setting  will  finalize  the  processed  data  and  not  allow  any  additional  data  to 
be  appended.  This  setting  should  be  disabled  (toggled  to  “no”)  when  multiple  sets  of  source  DTED 
(i.e.,  multiple  data  CDs)  will  be  used,  or  when  source  data  will  be  processed  in  multiple  parts. 
Disabling  this  setting  will  allow  the  user  to  process  the  current  set  of  source  data  and  resume 
processing  later  with  no  discontinuity. 

■  Set  Delete  Unfilled  Segments  (default  =  no):  Removes  partially  filled  processed  map  files  from  the 
final  processed  RDTED.  This  option  is  not  applicable  if  the  preceding  setting  {Set  Finalize 
Automatically)  is  disabled. 

■  Descriptive  Name:  A  name  for  this  processed  data  (maximum  of  16  ASCII  characters). 


The  RDTED  processing  dialog  shows  the  estimated  map  data  coverage  (after  processing)  for  each 
map  scale.  The  user  reviews  the  information  presented  on  the  dialog  box  and  either  commits  to  proceed 
with  RDTED  processing  by  clicking  the  PROCESS  button,  or  aborts  the  pending  action  by  clicking  the 
CANCEL  button. 

Next,  all  source  DTED  is  processed  into  RDTED  and  stored  in  the  selected  destination  directory.  If 
the  user  has  chosen  to  finalize  automatically,  an  A.TOC  file  is  created  at  the  \rpf  directory  level  (Fig.  19) 
and  the  processed  data  are  logged  in  MMCPC  to  create  compositions  and  TAMMAC  theater/mission  data 
loads.  If  the  user  has  chosen  not  to  finalize,  no  A.TOC  file  is  created,  and  the  processed  data  are  not 
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logged.  RDTED  data  cannot  be  used  to  create  compositions  or  TAMMAC  map  loads  until  they  have 
been  logged  (Section  2.1.3). 

The  error  checking  functions  used  in  RDTED  processing  provide  descriptive  error  messages  to  assist 
the  user  in  correcting  any  problems  associated  with  the  source  data.  For  example,  if  a  corrupt  DEED 
source  file  is  encountered,  MMCPC  will  attempt  to  read  the  remaining  files  and  report  any  errors 
associated  with  source  files  prior  to  exiting  RDTED  processing.  Consequently,  the  user  can  fix  all 
potential  problems  with  the  data  at  one  time. 

2.1.3  Logging  Data  Sources 

All  necessary  map  data  sources  (except  data  frames)  must  be  logged  before  any  theater/mission 
compositions  can  be  built.  Map  data  sources  are  either  logged  automatically  when  processed  map  data 
are  finalized  or  logged  via  a  MMCPC  function  call.  Figure  21  presents  an  overview  of  the  MMCPC  data 
logging  function,  which  includes  three  (color-coded)  phases:  1)  Define  the  source  data  location  (blue);  2) 
Determine  CADRG  /  RDTED  data  status  (orange);  and  3)  Log  processed  map  data  (yellow).  Appendix  H 
provides  a  complete  description  of  data  logging,  including  low-level  steps  within  each  phase. 


Fig.  21  —  High-level  flow  ehart  for  logging  data  sourees 


MMCPC  automatically  logs  all  finalized,  processed  map  data  that  reside  on  hard  disk  and  maintains 
all  logged  information  in  the  directory  C:\MMCPC\coverage\bitmaps\logged.  Important  note:  Do 
not  modify,  add,  or  delete  any  files  in  this  directory.  MMCPC  requires  that  logged  source  information 
(but  not  the  data  itself)  reside  in  this  directory.  Any  changes  made  to  the  directory  outside  of  MMCPC 
may  result  in  system  failure  and  loss  of  data. 

The  MMCPC  LOG  function  logs  external  map  data  sources  (e.g.,  NGA  CADRG  and  CIB)  not 
residing  on  hard  disk.  If  a  user  chooses  to  archive  processed  map  data  from  hard  disk  to  another  location 
(e.g.,  CD)  via  an  external  program,  those  data  must  be  logged  before  they  can  be  used  as  part  of  a 
composition.  MMCPC  will  delete  processed  map  data  on  hard  disk  when  the  equivalent  data  on  CD  have 
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been  logged,  to  prevent  the  logging  of  duplicate  map  data  sources.  Important  note:  The  user  is 
responsible  for  maintaining  all  CDs  containing  logged  map  data. 

All  logged  sources  are  identified  by  their  PUID.  For  map  data  processed  by  MMCPC,  the  PUID  is 
automatically  assigned  (e.g.,  FIAFCDRG0001_A).  For  map  data  used  directly  from  NGA,  the  PUID  is 
the  volume  header  of  the  NGA  source  (e.g.,  CDRGXONCTPC05_8).  Each  logged  source  is  stored  in 
an  MMCPC-specific  structure  known  as  a  world  array  bitmap  that  has  a  suffix  of  .wbr.  Each  logged 
source  has  a  unique  RPF  information  file  (with  suffix  .rif)  associated  with  its  world  array  bitmap.  The 
.rif  file  contains  a  descriptive  name  (10  characters),  date  stamp,  and  the  full  path  to  the  processed  map 
data. 

For  example,  the  files  associated  with  a  logged  source  having  a  PUID  of  CDRGFIAF0001_A  would 
include  CDRGFIAF0001_A.wbr  and  CDRGFIAF0001_A.rif.  When  data  are  unlogged  from  the 
system,  all  associated  map  data  residing  on  hard  disk  are  deleted.  The  unlogged  data's  world  array  bitmap 
and  information  files  are  not  deleted  but  copied  into  a  subdirectory  for  obsolete  files  and  retained  for 
archival  purposes  only. 

2. 1.3.1  Define  the  Source  Data  Location 

Figure  22  presents  a  control  flow  diagram  for  defining  the  source  data  location.  MMCPC 
automatically  logs  finalized,  processed  map  data  on  hard  disk.  For  external  map  data  (e.g.,  on  CD),  the 
user  must  invoke  the  LOG  function  from  the  DATA  PROCESSING  menu.  The  LOG  function  will 
prompt  for  the  data  location,  which  is  usually  a  CD  drive  but  could  be  a  network  drive  or  other  location. 
The  volume  label  (if  applicable)  and  a  valid  information  file  in  the  /rpf  directory  must  exist  for  the  map 
data  to  be  considered  a  valid  source.  If  the  data  are  not  on  hard  disk,  the  top-level  PUID  directory  (e.g., 
CDRGFIAF0001_A)  also  must  exist.  Important  note:  A  user  should  not  process  or  archive  data  nested 
inside  another  data  set  on  hard  disk  (e.g.,  never  attempt  to  archive  CDRGFIAF0002_A  in  the 
CDRGFIAF0001_A  directory). 

Once  a  location  has  been  defined,  MMCPC  checks  whether  the  source  data  have  been  processed  or 
are  from  NGA.  All  RDTED  must  be  processed,  so  the  only  data  to  be  logged  directly  from  NGA  are 
CADRG  and  CIB.  Next,  the  volume  label  and  directory  structure  are  validated.  For  processed  map  data, 
the  volume  label  should  be  the  PUID.  For  processed  map  data  on  CD,  the  top-level  directory  should  be 
/rpf.  The  user  must  enter  the  volume  name  for  the  archived  CD. 

If  the  map  data  to  be  logged  reside  on  a  networked  drive  or  other  location,  the  map  data’s  PUID  must 
exist  as  the  top-level  directory  in  lieu  of  the  volume  label.  For  NGA  map  data  sources,  the  last  character 
in  the  PUID  represents  the  edition  number  of  the  map  data  (this  differs  in  meaning  from  the  processed 
map  data  PUID)  and  indicates  an  overwrite  of  the  existing  logged  source. 
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Fig.  22  —  Control  flow  for  defining  the  souree  data  loeation 


2. 1.3.2  Determine  Data  Type  Status 

Figure  23  depicts  the  control  flow  for  determining  data  type  status.  If  the  source  CADRG  has  a 
different  color  palette  from  that  installed  on  MMCPC,  that  particular  scale  of  CADRG  cannot  be  logged. 
The  color  palette  for  each  zone  and  scale  must  be  checked  for  consistency.  If  the  user  wants  to  reinstall 
the  default  NGA  palettes,  this  process  is  handled  by  a  SYSTEM  menu  option. 

2.1.3.3  Log  Processed  Map  Data 

Figure  24  depicts  the  control  flow  for  logging  processed  map  data.  The  MMCPC-generated  PUID  or 
the  volume  ID  (for  NGA  data)  is  used  for  the  Identification  (ID)  file  name.  For  example,  an  ID  file  for 
CADRG  data  processed  from  FiAF  source  GeoTIFF  would  be  named  CDRGFIAF0001_A.rif.  The  ID 
file  resides  in  the  same  directory  as  its  corresponding  world  array  bitmap.  The  contents  of  the  ID  file  are 
listed  in  Appendix  J. 
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Fig.  23  —  Control  flow  for  data  type  status 


Fig.  24  —  Control  flow  for  logging  processed  map  data 


2.1.4  Data  Frame  Processing 

Data  frames  are  non-georeferenced  images  that  must  be  converted  to  HDF  for  compatibility  with 
TAMMAC.  Like  CADRG  data  and  RDTED,  data  frames  can  be  used  to  create  mission  and  theatre  loads. 
The  supported  data  frame  size  is  768  by  768  pixels.  Images  must  be  created  and  cropped  to  the  maximum 
allowable  size  prior  to  use  with  MMCPC.  Data  frames  are  loosely  associated  with  active  compositions; 
associations  only  become  permanent  when  the  composition  has  been  used  in  a  MAP  BUILD  operation. 
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Figure  25  presents  an  overview  of  data  frame  processing,  which  includes  viewing  and  selecting 
images  and  image  processing  phases.  Appendix  E  gives  a  full  description  of  data  frame  processing, 
including  low-level  steps  within  each  phase. 


Process/View 
Data  Frames 


1 

r 

View  and  Select  Image 

(Section  2.1 .4.1) 

1 

F 

Process  Image  and  Save  as 
Data  Frame  (Section  2.1 .4.2) 

Fig.  25  —  High-level  flow  ehart  for  data  frame  proeessing 


2.1.4.1  View  and  Select  Image 

Image  files  are  first  verified  for  proper  format,  readability,  and  size  (maximum  768  by  768  pixels). 
Larger  files  must  be  edited  (in  other  software)  to  meet  this  constraint.  Once  these  criteria  are  met,  the 
image  is  displayed  to  the  user,  who  can  choose  to  convert  the  file  to  a  data  frame.  Figure  26  presents  the 
control  flow  for  viewing  and  selecting  an  image  to  be  converted  to  a  data  frame. 
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Fig.  26  —  Control  flow  for  viewing  and  selecting  an  image  as  a  potential  data  frame 


2.1.4.2  Data  Frame  Image  Processing 

After  an  image  has  been  selected  to  be  a  data  frame,  the  input  destination  directory  is  defined  and 
verified  (Fig.  27).  If  it  does  not  yet  exist,  a  new  directory  is  automatically  created.  The  image  is 
compressed  to  8-bit  color,  if  necessary,  and  written  as  a  data  frame  in  the  specified  directory.  MMCPC 
then  returns  to  the  View  and  Select  Image  phase  (Section  2. 1.4. 1)  for  additional  images. 

2.2  Map  Compositions 

Map  compositions  are  user-defined  ROIs  based  on  logged  sources  for  CADRG,  CIB,  and  RDTED 
map  data.  Requirements  include  the  ability  to  create,  save,  and  edit  these  compositions.  There  are  two 
methods  of  building  a  composition  in  MMCPC  (Fig.  28):  building  a  new,  user-defined  composition 
(blue),  and  building  a  composition  based  on  other,  pre-existing  compositions  (orange).  Appendix  F 
provides  a  complete  description  of  map  composition  builds. 
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Fig.  27  —  Control  flow  for  data  frame  image  proeessing 


Fig.  28  —  High-level  flow  ehart  for  building  eompositions 
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2.2. 1  Build  from  Existing  Composition(s) 

Compositions  can  be  built  from  existing  user-defined  compositions  and  data  frames  (Fig.  29).  When 
an  import  file  is  opened,  all  associated  map  data  types  and  coverage  areas  must  exist  as  logged  sources. 
The  name  of  the  composition  defined  by  the  import  file  must  be  unique,  or  the  import  will  fail. 

When  data  frames  are  defined,  the  path  must  be  accessible  and  the  data  frame  source  files  must  be 
valid  image  file  types  (Section  2.1.4).  Up  to  100  data  frames  may  be  imported  for  use  in  a  composition. 
When  data  frames  are  processed,  an  association  is  made  between  the  processed  data  frames  and  the 
composition  designated  by  the  import  file. 

Import  files  are  not  valid  sources  for  “included”  compositions  because  they  cannot  be  used  to 
partially  define  a  composition.  However,  if  a  file  is  imported  and  the  coverages  are  modified,  it  is 
possible  for  a  composition  derived  from  this  file  to  be  no  longer  representative  of  its  original  coverage, 
and  can  be  saved  as  new. 


Fig.  29  —  Control  flow  chart  for  building  a  new  composition  based  on  an  existing  composition 
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2.2.2  Build  a  New  Composition 

There  are  three  primary  tools  for  defining 
and  creating  a  new  composition: 

1.  Define  a  rectangle  of  coverage  by  left- 
clicking  on  one  comer  and  dragging  the 
mouse  to  the  opposite  corner; 

2.  Define  a  more  precise  coverage  polygon  of 
coverage  by  left-clicking  on  points  to  define 
the  polygon,  and  double-clicking  to  close  it; 
and 

3.  Define  the  most  precise  coverage  polygon  of 
coverage  by  entering  a  series  of  latitude/ 
longitude  points  in  a  dialog  box  to  precisely 
define  a  polygon. 

Figure  30  depicts  the  control  flow  for 
building  a  new  composition.  A  user  may 
include  coverages  from  logged  sources  and  other 
user-defined  compositions  and  define  the  map 
data  type  and  scales.  Zoom  options  are  available 
to  reset  the  focus  to  a  particular  region  of  the 
world.  During  a  composition  build,  MMCPC 
calculates  the  estimated  composition  size  and 
notifies  the  user  if  it  is  expected  to  exceed  2.8 
GB  (the  maximum  size  of  a  TAMMAC  theater 
map  load).  If  so,  the  user  will  have  to  edit  the 
composition. 


Newly  created  compositions  are  unlocked  and  set  as  edition  “1”  until  they  are  used  for  map  builds 
(e  g.,  TEST_001.WBU).  When  a  map  build  is  successful,  that  composition  becomes  locked.  A  new 
edition  can  only  be  created  from  a  locked  composition  (e.g.,  TEST_001.WBL  TEST_002.WBU). 
This  new  edition  will  not  be  locked  until  it  too  is  successfully  used  in  a  map  build.  MMCPC  assigns  the 
edition  number  (_xxx),  which  is  not  part  of  the  unique  composition  name.  When  used  for  a  map  build, 
an  updated  composition  (i.e.,  a  new  edition)  will  only  load  the  difference  between  the  updated 
composition  and  its  previous  edition.  The  user  must  ensure  that  multiple  editions  are  properly  loaded  into 
TAMMAC  in  consecutive  order. 

2. 2. 3  Composition  Files 

A  composition  is  mapped  with  “world  array  bitmaps”  that  represent  the  composition’s  latitude/ 
longitude  positions.  There  are  three  types  of  these  bitmaps,  each  with  a  different  file  extension: 

1.  *.WBU  (World  Bitmap  Unlocked)  is  a  bitmap  representation  of  a  user-defined  ROI,  based  on 
available  logged  data  sources,  that  has  not  been  used  to  build  a  TAMMAC  map,  i.e.,  specific 
sources  have  not  been  locked  to  a  composition.  These  files  can  be  modified  and  saved  to  either 
the  original  name  or  a  new  name. 


Fig.  30  —  Control  flow  chart  for 
a  new  composition 
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2.  *.WBL  (World  Bitmap  Locked)  is  the  same  as  a  *.WBU  file,  except  it  been  used  for  a 
TAMMAC  map  build  and  therefore  has  been  locked  to  specific  logged  sources.  This  file  can  be 
saved  to  its  original  name,  but  must  have  a  new  edition. 

3.  *.WBX  is  the  same  as  a  *.WBL  file,  except  one  or  more  of  its  sources  has  been  unlogged  (i.e.,  is 
no  longer  available). 

2.3  Map  Data  Operations 

Map  Data  Operations  requirements  include  selecting  I/O  devices,  reading  and  displaying  data  and 
TAMMAC  theatre/mission  loads,  reading  and  writing  TAMMAC-specific  support  files,  computing 
checksums,  building  and  exporting  TAMMMAC  Theatre/Mission  Map  loads,  and  reading,  validating,  and 
restoring  color  maps. 

2. 3. 1  Build  Mission/Theater  Map  Load 

A  mission  and/or  theater  load  can  be  created  after  map  and  other  data  have  been  processed  for  an 
entire  ROI.  Figure  31  provides  an  overview  of  mission/theater  load  creation,  which  includes  four  critical 
phases  (color-coded  consistently  throughout  this  section):  1)  composition  lock  check  (blue),  2)  include 
data  frames  (orange),  3)  map  mission/theater  build  (yellow),  and  4)  saving  the  current  composition 
(green).  Appendix  G  provides  a  complete  description  of  mission/theater  load  creation,  including  low- 
level  steps  within  each  phase. 


Fig.  31  —  High-level  flowehart  for  building  a  mission/theater  map 


2.3.1. 1  Composition  Lock  Check 

In  this  step,  the  map  load  is  verified  for  compliance  with  size  constraints  (Fig.  32).  The  size  of  a  map 
load  depends  on  whether  the  build  is  for  a  mission  load  (typically  limited  to  20  MB)  or  a  theater  load 
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(limited  to  3  GB).  In  the  case  of  multiple  editions,  the  resultant  size  is  based  on  the  logical  “OR”  of  the 
current  and  all  preceding  versions  of  the  named  composition.  The  maximum  sizes  for  mission  and  theater 
loads  should  not  be  hard-coded;  these  values  should  be  set  in  a  parameter  file  loaded  at  MMCPC  startup. 
The  maximum  size  allows  for  some  overhead,  such  as  the  variability  of  frame  file  sizes  and  the  potential 
for  adding  data  frames. 


Fig.  32  —  Control  flow  for  composition  lock  check 


2.3.1.2  Include  Data  Frame(s) 

In  this  phase,  a  maximum  of  100  data  frames  can  be  included  as  part  of  the  mission/theater  load  (Fig. 
33).  Only  one  directory  of  data  frames  may  be  selected.  If  a  selected  directory  contains  more  than  100 
data  frames,  the  map  load  will  not  be  verified. 


30 


Myrick  et  ah 


2.3.1.3  Map  Theater/Mission  Build 

Figure  34  presents  the  control  flow  for  building  map  theater/mission  loads.  The  PC  card  size  is 
required  for  theater  loads,  since  a  theater  load  may  span  multiple  cards  (the  maximum  is  three  1-GB 
cards;  the  default  is  one  card).  Therefore,  the  data  structure  for  the  theater  map  files  must  be  sized 
appropriately  to  fit  on  each  card.  The  theater  card  size  should  be  loaded  from  a  parameter  file  at  MMCPC 
startup. 


Fig.  34  —  Control  flow  for  a  map  theater  or  mission  build 


The  theater  map-specific  files  include  an  ARC. DAT  file  (i.e.,  the  large  file  or  set  of  files  that  contain 
the  contents  of  the  map,  RDTED,  and  data  frames),  a  TIF.DAT  header  file  associated  with  each 
ARC. DAT  (if  spanned  over  multiple  PC  cards),  a  DIR.DAT  directory  listing  file  associated  with  each 
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ARC. DAT  file,  a  CONFIG. HRS  single  option  file,  and  symbol  set  files  (TEST.DAT,  100SDIR.HRS, 
and  002SDIR.SDR).  See  Appendix  G  of  Harris  (2001)  for  details. 

The  mission  map  load  does  not  include  an  ARC. DAT  file.  Individual  map  files  are  written  to  the  PC 
card  and,  since  mission  loads  are  very  small,  they  will  always  be  contained  on  a  single  card.  Mission- 
specific  files  include  individual  data  files  (CADRG,  CIB,  RDTED,  and  data  frames),  DIR.DAT  and 
TIF.DAT.  This  build  does  not  include  MF.DAT,  which  must  be  built  by  the  MPS  system  to  create  a  valid 
mission  load  to  PC  card.  See  Appendix  G  of  Harris  (2001)  for  details. 

2.3.1.4  Save  Current  Composition 

If  the  current  composition  has  not  been  saved,  it  will  fall  into  one  of  the  following  categories: 

1.  An  unlocked  composition  (WBU)  that  is  new  and  unnamed  or  modified  from  its  original,  and  can 
be  either  saved  to  its  previous  name  or  to  a  new  name; 

2.  An  obsolete  composition  (WBX)  that  may  or  may  not  be  modified  but  must  now  be  saved  as  an 
unlocked  composition  with  a  new  name; 

3.  A  locked  composition  (WBL)  that  has  been  modified  and  can  be  saved  to  either  a  new  name  or  as 
a  new  edition  to  its  current  name. 

For  each  condition,  resulting  saved  composition  becomes  an  unlocked  WBU  file  (Fig.  35). 


Fig.  35  —  Control  flow  for  saving  the  current  composition 
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2.4  Graphical  User  Interface  (GUI) 

Figure  36  shows  the  main  GUI  for  MMCPC  version  1.0.  Each  GUI  component  can  be  linked  to  one 
or  more  functional  requirements  within  the  concept  areas  of  Data  Processing,  Map  Compositions,  and 
Map  Data  Operations.  Shortcuts  and  hotkeys  for  GUI  options  are  defined,  as  are  actions,  conditions,  and 
usage  (i.e.,  when  a  menu  option  is  available  for  use).  Since  a  primary  goal  was  to  create  a  similar 
appearance  and  behavior  found  in  other  commercial  software,  comparable  design  conventions  were 
followed.  Appendix  B  lists  main  menu  and  submenu  options  and  the  functional  requirement(s)  being 
met.  The  MMCPC  Software  Users  Manual  provides  a  full  description  of  the  GUI  and  common 
operations. 


Fig.  36  —  MMCPC  Main  GUI 


2.5  Error  Checking  and  Handling 

MMCPC  uses  an  error  handling  methodology  that  detects  error  conditions  and  issues  status  messages 
for  the  following  categories: 

1.  Critical  errors  and  messages:  Occur  when  an  action(s)  will  force  termination  of  MMCPC.  These 
errors  could  result  from  software  errors,  changes  made  to  the  system  outside  MMCPC,  or 
physical  removal  of  required  components  needed  by  MMCPC  to  operate  properly. 

2.  Warning  errors  and  messages:  Occur  through  the  use  of  unanticipated  combinations  of  functions 
within  MMCPC  (i.e.,  programming  errors)  or  by  improper  user  input.  In  either  case,  usually  the 
function  within  MMCPC  (e.g.  CADRG  processing)  in  which  the  warning  occurred  will  not  be 
able  to  proceed  or  properly  complete.  However,  MMCPC  should  still  continue  to  operate. 
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3.  Information  messages:  Any  other  messages  that  do  not  result  in  an  aborted  process  within  MMCPC 
(e.g.,  notification  that  new  color  palettes  have  been  detected  or  that  CADRG  processing  has 
completed). 
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Appendix  A 

SOFTWARE  REQUIREMENTS  MATRIX 


Table  A1  defines  the  color  conventions  used  in  the  software  requirements  matrix.  Table  A2  defines 
acronyms  and  abbreviations  used  in  the  matrix. 


Table  A1  —  Color  Conventions  Used  in  Software  Requirements  Matrix 


Cell  Color 

Meaning 

Indicates  a  Data  Processing  (DP)  requirement 

Indicates  a  Map  Composition  (MCP)  requirement 

Indicates  a  Map  Data  Operations  (MDO)  requirement 

Indicates  a  non-testable  requirement  within  MMC 

Indicates  an  obsolete  requirement 

Red  Text 

Indicates  text  modifications  within  a  requirement 

Strike  through  text 

Indicates  deleted  text 

Table  A2  —  Acronyms  Used  in  Software  Requirements  Matrix  (Origin  Field) 


Acronym 

Origin  of  Requirement 

FiAF 

Finnish  Air  Force-specific  requirement  for  MMCPC 

MMC 

A  carryover  requirement  from  MMC  over  to  MMCPC 

PDR 

Preliminary  Design  Review  on  1/20/04 

TIM 

Technical  Information  Meeting  on  4/28/04 
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Icon  and  Button  Options  (continued) 


60 


Myrick  et  ah 


a> 

E 

E 

o 

o 


o* 

a> 

U 

S 


(O 

o 

o 

a. 

o 


00 

CO 

o 

o 

CL 

o 


CFJ 

CO 

o 

o 

□l 

o 


o 

o 

o 

CL 

o 


a 

o 

I 

CL 

O 


LO 

o 

o 

I 

□- 

o 


CN 

LO 

O 

O 

I 

□- 

O 


CO 

o 

o 

CL 

O 


o 

(O 

o 

o 

p 

o 

Q 


(O 

o 

o 

I 

O 

D 


O 

ISI 

> 


t/i 

CO 

U 


CL 

0) 


O  n> 

fllfe 

t  E  tD:3> 
o  (0 

"S  i  i  ^ 

.!2  -D  TO  ® 

F  E 

I—  CO  CJ  Cfl 


CO 


CO 


o 

>  ^  0) 
CD  xt  CL 

^  ®  ^■ 

0  g  CL 

C  S  TO 

g  “  ^ 

ig  I 

CD  CD  ^ 

-T  —  ir 


0) 


CO  CD  CO 
CO  o  >  ^ 
>  to  CD  CJ 


_  JO 

s  ? 

—  CD 


CO 

TO  5 

^  o 

to 

a>  -o 

C  CD 

1  ” 
TO  CD 
TO  g 
Tj 

CO  CO 
^  TO 

I—  "D 


^  to  ^ 

3  «  F 

±i  -O  TO  ® 

.  C  Q,  9- 
E  TO  *0  ^ 

TO  gJ  TO 
to  ’9  TO 
O  TO  to  'O 

CLO  CD  ^ 

^ 

O  TO  O  TO 

CJ  to  CO  CD 


CO 

c 

o 

'i? 

c 

o 

o 


“  £ 

o  CD  TO 

TO  0^  ±:;  ,c0  TO 

^  <  ra  m  ®  - 

■5o;so1q 


TO 

TO  Q  TO 


Q  ^ 

-  ^  TO  Q 


TO  g  -S  -D  ^  O 
C  c5  ^  t3  c  ^  lO 

—  to  CO  CO 


Q. 

TO  O 

E  K 

^  Q 

S  < 
45  O 

0  TO 

-C  Q. 


to 

c 

o 

'iS 

o 


a. 

TO 

e 


’TO 

■> 

.£ 

TO) 


TO  7= 
CD  TO 
O  TO 

:=  ” 

0  o 

(5cl  E 


O 

a: 

TO 

Q 


o  ^ 

o  E 

N  TO 


TO 

"5 

E 

F 

o 

s 

TO 

> 

o 

on 

TO 

O 

E 

o 

o 

N 


o 

Q. 

TO 

E 

o 


£ 

o 

o 

N 


TO 

E 

o 

TO 

TO 


O 

Q. 

TO 

O 


£ 

o 

o 

N 


CO 

o 

Q 

LU 

H 

Q 

□C 

d 

DC 

Q 

< 

U 

TO 

CL 

a. 

TO 


TO 

TO 

</) 


CL 

TO 


■g 

> 


i_  Q 
TO  = 
CD  ^ 
O  TO 
(Z  to 


■TO 

TO 

O 


TO 

■TO 


Q 

CL 


■TO 

TO 

O 


>s 

TO 


O 

X 


Nl 


TO 

D) 

CO 

£ 


El 


1^ 

\ 


l/ 


a> 

c  c 
cn 

S  yj 

X  TO 

liJ  -o 


o 


OJ 

c  c 

TO> 

X  TO 

UJ  X 


O 


05 

C  C 
TO! 

^  (0 

X  TO 

LU  X 


o 


TO> 

C  C 
.*=  oi 
~  to 

X  TO 

LU  X 


o 


05 

C  C 

TOl 

,«  TO 
X  TO 
LU  X 


TO 

X 

5 

CD 


TO 

X 

5 

CD 


Appendix  C 

LOW-LEVEL  FLOW  CHART  FOR  CADRG  PROCESSING 
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Appendix  D 

LOW-LEVEL  FLOW  CHART  FOR  RDTED  PROCESSING 
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Appendix  E 

LOW-LEVEL  FLOW  CHART  FOR  DATA  FRAME  PROCESSING 
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Appendix  F 

LOW-LEVEL  FLOW  CHART  FOR  COMPOSITION  CREATION 


f  Create  A 
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Appendix  G 

LOW-LEVEL  ELOW  CHART  EOR  MAP  BUILD  METHODOLOGY 
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Appendix  H 

LOW-LEVEL  ELOW  CHART  FOR  DATA  LOGGING 
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Appendix  I 

INPUT  FILE:  FORMATS  AND  NAMING  CONVENTIONS 


This  Appendix  provides  information  about  the  input  data  sources  processed  by  MMCPC  (Table  I-l). 
In  addition  to  the  supported  Finnish-specific  map  data  (defined  below),  MMCPC  also  reads  the  following 
data  types; 

11.  CADRG 

For  more  information  about  CADRG,  refer  to  the  NGA  specification  for  CADRG  (NGA  1994). 

12.  CIB 

For  more  information  about  CIB,  refer  to  the  NGA  specification  for  CIB  (NGA  1995). 

13.  Data  Frames 

For  more  information  about  data  frames,  refer  to  the  Database  Design  Document  for  the  TAMMAC 
Map  (Harris  2002). 

14.  DTED 

MMCPC  will  support  only  DTED  level  1 .  DTED  level  post  (elevation)  spacing  is  defined  in  Section 
3.9  of  the  DTED  military  specification  (NGA,  2000).  Source  data  from  NGA  and  FiAF  are  acceptable 
inputs  to  MMCPC: 

■  NGA  DTED:  for  more  information,  refer  to  the  NGA  specification  for  DTED  (NGA  2000). 

■  FiAF  DTED;  the  directory  structure  and  file  naming  convention  of  FiAF  DTED  must  conform  to  the 
format  defined  in  the  DTED  military  specification,  MIL-PRF-89020A,  Section  3.14.2  with  the 
exception  that  FiAF  DTED  is  not  required  to  have  a  gazetteer,  a  DMED  file,  text  files,  or  the 
GAZETTE  or  TEXT  directories. 

15.  GeoTIFF 

Source  data  from  NGA  and  FiAF  are  acceptable  inputs  to  MMCPC.  All  files  must  contain  a  TIF 
suffix  (e.g.,  ABCDEFGH.TIF).  For  more  information  about  the  GeoTIFF  file  format,  refer  to  the 
GeoTIFF  Working  Group  specification  (2000). 

16.  Digital  Map  System  (DMS) 

For  more  information  about  DMS,  refer  to  the  TAMMAC  performance  specification  for  the  DMC 
(Harris  2001). 
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Appendix  J 

OUTPUT  FILE:  FORMATS  AND  NAMING  CONVENTIONS 
Jl.  Composition  Information  Files  (CIF) 

The  file  naming  convention  for  CIF  files  is  the  composition  name  appended  with  the  version  number 
with  extension  CIF  (e.g.,  NAME01.CIF).  CIF  files  contain  descriptive  information  about  compositions 
and  include  the  following  fields  (one  per  line  in  the  ASCII  file): 

■  Composition  name 

■  Version  number 

■  Status  (LOCKED/UNLOCKED) 

■  Specific  source  listings  (not  applicable  for  unlocked  compositions) 

■  List  of  associated  data  frames  with  directory  paths 

All  user-defined  compositions  and  CIF  files  must  be  stored  in  one  specific  directory.  The  sources  used 
for  locked  compositions  are  written  to  the  .CIF  file,  which  references  the  PUID  (processed  unique  ID) 
used  to  create  the  map  load.  The  PUID  is  the  name  of  the  .RIF  files  stored  in  the  logged  sources 
directory.  These  files  store  the  current  location  of  the  map  data. 

J2.  Raster  Product  Format  (RPF)  Information  Files  (RIF) 

The  file  naming  convention  for  RIF  files  is  the  MMCPC-generated  unique  PUID  (for  processed  data) 
or  the  volume  ID  (NGA  data)  with  the  extension  .RIF  (e.g.,  CDRGFIAF0001_A.rif).  RIF  files  reside  in 
the  same  directory  as  their  corresponding  world  array  bitmaps  and  contain  the  following  information: 

■  Descriptive  name  (30  characters) 

■  Date  stamp  of  when  processing  begins 

■  Full  path  to  the  processed  map  data 

■  Locked  compositions  that  use  this  logged  source  (i.e.,  a  list  of  all  compositions  added  to  this  file  as 
compositions  are  locked) 

J3.  Theater-Specific  Map  files 

The  theater-specific  map  files  include  the  following: 

■  ARC. DAT  -  a  large  file  or  set  of  files  containing  the  map,  RDTED,  and  data  frames 

■  DIR.DAT  -  a  directory  listing  file  for  each  ARC. DAT  file 

■  TIF.DAT  -  a  header  file  for  each  ARC. DAT  (if  spanned  over  multiple  PC  cards) 

■  CONFIG. HRS  -  a  single  option  file 

■  Symbol  set  files  -TEST.DAT,  100SDIR.HRS,  and  002SDIR.SDR 

J4.  Mission-Specific  Map  Files 

The  mission-specific  map  load  does  not  utilize  an  ARC. DAT  file.  Individual  map  files  are  written  to 
the  PC  card.  Since  mission  loads  are  very  small,  they  will  always  be  contained  on  a  single  PC  card.  The 
mission  specific  map  files  include  individual  map  data  files  (e.g.,  CADRG,  CIB,  RDTED,  Dataframes), 
DIR.DAT,  TIF.DAT,  but  not  MF.DAT,  which  must  be  built  by  the  MPS  system  to  create  a  valid  mission 
load  to  PC  card.  The  reader  is  referred  to  the  DMC  Specification  (Harris  2001),  Appendix  G  for  details. 

J5.  World  Array  Bitmap  Files 

Bitmap  arrays  represent  global  lat/lon  positions.  MMCPC  builds  compositions  from  these  “world 
array  bitmaps,”  of  which  there  are  three  types,  each  with  a  different  file  extension: 
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1.  *.WBU  (World  Bitmap  Unlocked)  is  a  bitmap  representation  of  a  user-defined  ROI,  based  on 
available  logged  data  sources,  that  has  not  been  used  to  build  a  TAMMAC  map.  Le.,  specific 
sources  have  not  been  locked  to  a  composition.  These  files  can  be  modified  and  saved  to  either  the 
original  name  or  a  new  name. 

2.  *.WBL  (World  Bitmap  Locked)  is  the  same  as  a  *.WBU  file,  except  it  1^  been  used  for  a 
TAMMAC  map  build  and  therefore  has  been  locked  to  specific  logged  sources.  This  file  can  be 
saved  to  its  original  name,  but  must  have  a  new  edition. 

3.  *.WBX  is  the  same  as  a  *.WBL  file,  except  one  or  more  of  its  sources  has  been  unlogged  (i.e.,  is 
no  longer  available). 


Appendix  K 

GLOSSARY  OF  ACRONYMS  AND  TERMS 


Kl.  Acronyms 

The  acronyms  and  abbreviations  used  in  this  document  are  defined  in  Table  Kl. 


Table  Kl  —  Acronyms  Used  In  this  Document 


Acronym 

Definition 

CAC 

Compressed  Aeronautical  Chart 

CADRG 

Compressed  ARC  Digitized  Raster  Graphics 

CD 

Compact  Disk 

CIB 

Controlled  Image  Base 

GIF 

Composition  Information  File 

DEC 

Digital  Equipment  Corporation 

DMC 

Digital  Map  Computer 

DMS 

Digital  Map  System 

DIED 

Digital  Terrain  Elevation  Data 

FiAF 

Finnish  Air  Force 

GeoTIFF 

Geospatial  Tagged  Image  File  Format 

GIF 

Graphics  Interchange  Format 

GUI 

Graphical  User  Interface 

HDF 

Harris  Defined  Format  (data  frame  format) 

MMC 

Moving-Map  Composer  (precursor  to  MMCPC) 

MMCPC 

MMC  Personal  Computer 

MPS 

Mission  Planning  System 

NAVAIR 

Naval  Air  Systems  Command 

NGA 

National  Geospatial-Intelligence  Agency  (formerly  NIMA) 

NIMA 

National  Imagery  and  Mapping  Agency  (now  NGA) 

NRL 

Naval  Research  Laboratory 

PCMCIA 

Personal  Computer  Memory  Card  International  Association 

PUID 

Processed  Unique  Identification 

RDTED 

Regridded  Digital  Terrain  Elevation  Data 

RIF 

RPF  Information  File 

ROI 

Region  of  Interest 

RPF 

Raster  Product  Format 

TAM MAC 

Tactical  Aircraft  Moving  Map  Capability 

TIF 

Tagged  Image  File 

TOC 

Table  of  Contents 

WBL 

World  Bitmap  Locked 

WBU 

World  Bitmap  Unlocked 

WBX 

World  Bitmap  Locked  but  unavailable 
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K2.  Processing  Terms 
Composition  (for  a  Region  of  Interest) 

A  composition  is  a  user-defined  geographic  coverage  area  (or  set  of  areas)  saved  as  a  series  of 
bitmaps  (Fig.  Kl).  A  composition  includes  a  bitmap  for  each  contiguous  geographic  area,  within  each 
zone,  and  at  each  map  scale  required  to  build  a  Mission  or  Theater  Map.  Each  “bit”  in  the  composition’s 
bitmap(s)  represents  a  single  segment  of  CADRG  data  (and/or  RDTED). 

Image 

An  image  is  the  actual  data  (including  CADRG,  processed  map  data,  RDTED,  or  some  combination) 
to  be  used  in  a  Mission  or  Theater  Map.  MMCPC  constructs  an  image  from  a  composition’s  bitmaps. 
Figure  K2  is  a  sample  image  comprised  of  processed  Finn  source  data. 


Fig.  Kl  —  Sample  composition 


Fig.  K2  —  Sample  image 
(processed  1:500  k  scale  data) 


K3.  DATATYPES 
Compressed  ADRG  (CADRG) 

Produced  and  distributed  on  CD-ROM  by  NIMA,  CADRG  was  designed  to  be  a  jointly  coordinated 
compression  of  ADRG  to  be  used  in  any  application  requiring  rapid  display  of  a  map  image  or 
manipulation  of  the  image  of  a  map  in  raster  form.  CADRG  achieves  a  nominal  compression  of  55:1  over 
ADRG,  excluding  supplemental  data  such  as  color  palettes  and  codebooks.  CADRG  is  processed 
similarly  to  CAC,  except  that  CADRG  has  a  data  density  of  169  pixels  per  inch  (CAC  is  128  ppi)  and 
CADRG  maintains  the  ARC  coordinate  system  of  ADRG  (CAC  uses  the  TS  projection  system).  CADRG 
will  replace  CAC  as  the  standard  raster  chart  data  to  be  used  in  the  TAMMAC  cockpit  moving-map 
systems.  For  more  details,  refer  to  NIMA’s  Digitizing  the  Future  report  or  website  (NIMA  1997). 

Digital  Terrain  Elevation  Data  (DTED) 

DTED  is  a  uniform  matrix  of  terrain  elevation  values  that  provides  basic  quantitative  data  for  systems 
requiring  terrain  elevation,  slope,  and/or  gross  surface  roughness  information.  DTED  is  produced  and 
distributed  on  CD-ROM  by  NIMA.  DTED  is  available  at  two  resolutions  (summarized  in  Table  K2): 

■  Level  1:  Content  is  comparable  to  the  contour  information  on  a  1:250k  scale  chart.  Latitudinal  post 
spacing  is  3  arc  seconds  (about  100  m);  longitudinal  post  spacing  varies  by  latitude. 

■  Level  2:  Content  is  comparable  to  the  contour  information  on  a  1:50k  scale  chart.  Latitudinal  post 
spacing  is  1  arc  second  (about  30  m);  longitudinal  post  spacing  varies  by  latitude. 
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Table  K2  —  DTED  Longitudinal  Post  Spacing  (Level  1  vs  Level  2) 


Zone 

Lat  Bounds 

Post  Spacing  (arc  sec) 

Level  1 

Level  2 

1 

0°  -  50°  N/S 

3 

1 

II 

50°  -  70°  N/S 

6 

2 

III 

70°  -  75°  N/S 

9 

3 

IV 

75°  -  80°  N/S 

12 

4 

V 

80°  -  90°  N/S 

18 

6 

For  more  information  about  DTED,  refer  to  the  NGA  specification  for  DTED  (NGA  2000)  or  the  NGA 
website  (www.nga.mil). 

World  Vector  Shoreline  (WVS) 

WVS  is  the  base  map  for  defining  coverages  for  AOD  images  and  MPS-CD  images  on  the  MMC  and 
MMCPC  workstations.  WVS  is  a  standard  NGA  digital  product  consisting  of  the  shorelines,  international 
boundaries,  and  country  names  of  the  world.  The  uncompressed  version  of  WVS  averages  12  data  points 
per  nautical  mile  (nmi),  approximately  equivalent  to  the  data  density  of  a  scanned  1:250k  scale  chart. 
WVS  conforms  to  the  WGS  84  datum.  Compressed  and  thinned  versions  of  WVS  are  also  available  from 
NGA.  For  more  details,  refer  to  the  NGA  website  (www.nga.mil). 

K4.  CHART  SERIES,  SCALES  AND  DISPLAY  RANGES 

Chart  series  and  geographic  scale  typically  refer  to  paper  chart  products:  a  Joint  Operations  Graphic 
(JOG)  chart  series  is  produced  at  a  scale  of  1:250k,  which  means  that  1”  on  the  chart  represents  250,000” 
on  the  ground.  For  aeronautical  charts,  larger  scales  (e.g.,  1:50k  and  1:100k)  provide  more  detailed  map 
information  for  low-altitude  flying  or  approach  and  landing  operations.  Smaller  scales  (e.g.,  1:2M  and 
1:5M)  are  used  for  faster  flying  at  high  altitudes  (e.g.,  cross-country  flights). 

The  term  map  scale  is  not  always  appropriate  for  digital  map  products,  since  the  actual  scale  may 
become  distorted  by  zooming  or  subsampling  the  data.  For  digital  charts,  it  may  be  more  useful  to  refer 
to  display  range  (i.e.,  the  number  of  nautical  miles  from  top  to  bottom  of  the  screen  on  which  the  digital 
chart  is  displayed).  Table  K3  lists  common  aeronautical  chart  series,  with  their  geographic  scales  and 
normal  (pre-zoom)  display  ranges.  The  table  also  indicates,  for  each  chart  series,  if  it  is  supported  by 
current  moving-map  displays  and  if  it  will  be  supported  under  the  new  TAMM  AC  systems. 


80 


Myrick  et  ah 


Table  K3  —  Common  Aeronautical  Chart  Series,  Scales,  and  Display  Ranges 


Chart  Series 

Scale"' 

Display 
Range  (nmi)*^ 
AV-8B  F/A-18 

In 

current 

system? 

In 

TAMMAC 

system? 

Global  Navigation  Chart  (GNC) 

1:5M 

200 

160 

No 

No 

Jet  Navigation  Chart  (JNC) 

1:2M 

100 

80 

Yes 

Yes 

Operational  Navigation  Chart  (ONC) 

1:1M 

50 

40 

No*^ 

No*^ 

Tactical  Pilotage  Chart  (TPC) 

1:500k 

25 

20 

Yes 

Yes 

Joint  Operationai  Graphics  (JOG) 

1:250k 

13 

10 

Yes 

Yes 

Topographic  Line  Map-100  (TLM-100) 

1:100k 

5 

4 

No 

No 

Topographic  Line  Map-50  (TLM-50) 

1:50k 

3 

2 

No 

No 

City  Graphics  (CG) 

1:12.5k 

No 

No 

For  map  scales,  M  =  million,  k  =  thousand. 

AV-8B  and  F/A-18  use  the  same  display  but  calculate  range  differently  (Trenchard  et  al.1995). 

The  ONC  series  is  not  supported  in  current  systems;  instead,  pilots  can  zoom  into  the  JNC 
chart  by  2:1  to  simulate  an  ONC  display  range. 

K5.  AGENCIES  AND  COMPANIES 
National  Geospatial-Intelligence  Agency  (NGA) 

NGA  (formerly  NIMA)  produces  and  distributes  standard  cartographic  databases  that  support  the 
cockpit  moving-map,  MAP-II,  MPS-II,  and  MDS-II  systems,  including  CAC,  DTED,  and  WVS. 

National  Imagery  and  Mapping  Agency  (NIMA) 

NIMA  has  been  reorganized  and  renamed  to  NGA. 

Naval  Research  Laboratory  (NRL) 

The  NRL  Mapping  Sciences  Section  (Code  7440.1)  developed  the  FiAF  MMC  workstation  and 
Moving-Map  Composers  (MMC)  software  for  the  AV-8B  Muxbus  Data  System.  NRL  Code  7440.1  is 
located  at  the  Stennis  Space  Center,  MS,  which  is  on  the  Gulf  of  Mexico  approximately  70  miles 
northeast  of  New  Orleans,  LA.  The  following  are  key  NRL  personnel  in  this  effort: 

Project  Team  Leader:  Maura  Lohrenz 

Project  Engineers:  Michael  Trenchard,  Stephanie  Myrick,  Marlin  Gendron,  Geary  Layne,  Marvin 

Roe,  Stephanie  Edwards,  and  Lance  Riedlinger  (contractor  with  Planning 
Systems,  Inc.). 


